home *** CD-ROM | disk | FTP | other *** search
CCCCSSSSRRRROOOOTTTT((((3333SSSS)))) CCCCSSSSRRRROOOOTTTT((((3333SSSS)))) NNNNAAAAMMMMEEEE CCCCSSSSRRRROOOOTTTT, ZZZZDDDDRRRROOOOTTTT - Applies a real plane rotation to a pair of complex vectors SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS Single precision complex Fortran: CCCCAAAALLLLLLLL CCCCSSSSRRRROOOOTTTT ((((_n,,,, _x,,,, _i_n_c_x,,,, _y,,,, _i_n_c_y,,,, _c,,,, _s)))) C/C++: ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>> vvvvooooiiiidddd ccccssssrrrrooootttt ((((iiiinnnntttt _n,,,, ssssccccssssllll____ccccoooommmmpppplllleeeexxxx *_x,,,, iiiinnnntttt _i_n_c_x,,,, ssssccccssssllll____ccccoooommmmpppplllleeeexxxx *_y,,,, iiiinnnntttt _i_n_c_y,,,, ffffllllooooaaaatttt _c,,,, ffffllllooooaaaatttt _s))));;;; C++ STL: ####iiiinnnncccclllluuuuddddeeee <<<<ccccoooommmmpppplllleeeexxxx....hhhh>>>> ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>> vvvvooooiiiidddd ccccssssrrrrooootttt ((((iiiinnnntttt _n,,,, ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>> *_x,,,, iiiinnnntttt _i_n_c_x,,,, ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>> *_y,,,, iiiinnnntttt _i_n_c_y,,,, ffffllllooooaaaatttt _c,,,, ffffllllooooaaaatttt _s))));;;; Double precision complex Fortran: CCCCAAAALLLLLLLL ZZZZDDDDRRRROOOOTTTT ((((_n,,,, _x,,,, _i_n_c_x,,,, _y,,,, _i_n_c_y,,,, _c,,,, _s)))) C/C++: ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>> vvvvooooiiiidddd zzzzddddrrrrooootttt ((((iiiinnnntttt _n,,,, ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx *_x,,,, iiiinnnntttt _i_n_c_x,,,, ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx *_y,,,, iiiinnnntttt _i_n_c_y,,,, ddddoooouuuubbbblllleeee _c,,,, ddddoooouuuubbbblllleeee _s))));;;; C++ STL: ####iiiinnnncccclllluuuuddddeeee <<<<ccccoooommmmpppplllleeeexxxx....hhhh>>>> ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>> vvvvooooiiiidddd zzzzddddrrrrooootttt ((((iiiinnnntttt _n,,,, ccccoooommmmpppplllleeeexxxx<<<<ddddoooouuuubbbblllleeee>>>> *_x,,,, iiiinnnntttt _i_n_c_x,,,, ccccoooommmmpppplllleeeexxxx<<<<ddddoooouuuubbbblllleeee>>>> *_y,,,, iiiinnnntttt _i_n_c_y,,,, ddddoooouuuubbbblllleeee _c,,,, ddddoooouuuubbbblllleeee _s))));;;; IIIIMMMMPPPPLLLLEEEEMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN These routines are part of the SCSL Scientific Library and can be loaded using either the ----llllssssccccssss or the ----llllssssccccssss____mmmmpppp option. The ----llllssssccccssss____mmmmpppp option directs the linker to use the multi-processor version of the library. When linking to SCSL with ----llllssssccccssss or ----llllssssccccssss____mmmmpppp, the default integer size is 4 bytes (32 bits). Another version of SCSL is available in which integers are 8 bytes (64 bits). This version allows the user access to larger memory sizes and helps when porting legacy Cray codes. It can be loaded by using the ----llllssssccccssss____iiii8888 option or the ----llllssssccccssss____iiii8888____mmmmpppp option. A program may use only one of the two versions; 4-byte integer and 8-byte integer library calls cannot be mixed. The C and C++ prototypes shown above are appropriate for the 4-byte integer version of SCSL. When using the 8-byte integer version, the variables of type iiiinnnntttt become lllloooonnnngggg lllloooonnnngggg and the <<<<ssssccccssssllll____bbbbllllaaaassss____iiii8888....hhhh>>>> header PPPPaaaaggggeeee 1111 CCCCSSSSRRRROOOOTTTT((((3333SSSS)))) CCCCSSSSRRRROOOOTTTT((((3333SSSS)))) file should be included. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN These routines apply a real plane rotation to a pair of complex vectors. The form of the operation is the following: _ _ _ _ _ _ | x | | c s | | x | | i | | | | i | | | | | | | | y |:= | -s c | | y | | i | | | | i | - - - - - - for each pair of values (_x(_i), _y(_i)), _i=1,..., _n See the NOTES section of this man page for information about the interpretation of the data types described in the following arguments. This routine has the following arguments: _n Integer. (input) Number of pairs of elements of _x and _y to be rotated. _x Array of dimension (_n-1) * |_i_n_c_x| + 1. (input and output) CCCCSSSSRRRROOOOTTTT: Single precision complex array. ZZZZDDDDRRRROOOOTTTT: Double precision complex array. On input, array _x. If _i_n_c_x > 0, _x(_i) is stored in _x(1+(_i-1) * _i_n_c_x); if _i_n_c_x < 0, _x(_i) is stored in _x(1-(_n-_i) * _i_n_c_x). On output, the rotated vector _x. _i_n_c_x Integer. (input) Increment between elements of _x. _i_n_c_x should not be 0. _y Array of dimension 1+(_n-1) * |_i_n_c_y|). (input and output) CCCCSSSSRRRROOOOTTTT: Single precision complex array. ZZZZDDDDRRRROOOOTTTT: Double precision complex array. On input, array _y. If _i_n_c_y > 0, _y(_i) is stored in _y(1+(_i-1) * _i_n_c_y); if _i_n_c_y < 0, _y(_i) is stored in _y(1-(_n-_i) * _i_n_c_y). On output, the rotated vector _y. _i_n_c_y Integer. (input) Increment between elements of _y. _i_n_c_y should not be 0. _c Cosine of the angle of rotation. (input) CCCCSSSSRRRROOOOTTTT: Single precision. ZZZZDDDDRRRROOOOTTTT: Double precision. PPPPaaaaggggeeee 2222 CCCCSSSSRRRROOOOTTTT((((3333SSSS)))) CCCCSSSSRRRROOOOTTTT((((3333SSSS)))) _s Sine of the angle of rotation. (input) CCCCSSSSRRRROOOOTTTT: Single precision. ZZZZDDDDRRRROOOOTTTT: Double precision. NNNNOOOOTTTTEEEESSSS These routines are extensions to the Level 1 BLAS. DDDDaaaattttaaaa TTTTyyyyppppeeeessss The following data types are described in this documentation: TTTTeeeerrrrmmmm UUUUsssseeeedddd DDDDaaaattttaaaa ttttyyyyppppeeee Fortran: Array dimensioned _n xxxx((((nnnn)))) Integer IIIINNNNTTTTEEEEGGGGEEEERRRR (IIIINNNNTTTTEEEEGGGGEEEERRRR****8888 for ----llllssssccccssss____iiii8888[[[[____mmmmpppp]]]]) Single precision RRRREEEEAAAALLLL Double precision DDDDOOOOUUUUBBBBLLLLEEEE PPPPRRRREEEECCCCIIIISSSSIIIIOOOONNNN Single precision complex CCCCOOOOMMMMPPPPLLLLEEEEXXXX Double precision complex DDDDOOOOUUUUBBBBLLLLEEEE CCCCOOOOMMMMPPPPLLLLEEEEXXXX C/C++: Array dimensioned _n xxxx[[[[_n]]]] Integer iiiinnnntttt (lllloooonnnngggg lllloooonnnngggg for ----llllssssccccssss____iiii8888[[[[____mmmmpppp]]]]) Single precision ffffllllooooaaaatttt Double precision ddddoooouuuubbbblllleeee Single precision complex ssssccccssssllll____ccccoooommmmpppplllleeeexxxx Double precision complex ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx C++ STL: Array dimensioned _n xxxx[[[[_n]]]] Integer iiiinnnntttt (lllloooonnnngggg lllloooonnnngggg for ----llllssssccccssss____iiii8888[[[[____mmmmpppp]]]]) Single precision ffffllllooooaaaatttt Double precision ddddoooouuuubbbblllleeee PPPPaaaaggggeeee 3333 CCCCSSSSRRRROOOOTTTT((((3333SSSS)))) CCCCSSSSRRRROOOOTTTT((((3333SSSS)))) Single precision complex ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>> Double precision complex ccccoooommmmpppplllleeeexxxx<<<<ddddoooouuuubbbblllleeee>>>> SSSSEEEEEEEE AAAALLLLSSSSOOOO IIIINNNNTTTTRRRROOOO____SSSSCCCCSSSSLLLL(3S), IIIINNNNTTTTRRRROOOO____BBBBLLLLAAAASSSS1111(3S), SSSSRRRROOOOTTTT(3S), SSSSRRRROOOOTTTTGGGG(3S), SSSSRRRROOOOTTTTMMMM(3S) IIIINNNNTTTTRRRROOOO____CCCCBBBBLLLLAAAASSSS(3S) for information about using the C interface to Fortran 77 Basic Linear Algebra Subprograms (legacy BLAS) set forth by the Basic Linear Algebra Subprograms Technical Forum. PPPPaaaaggggeeee 4444 
